package com.starhub.application.collection.service;

import java.util.List;

import com.starhub.application.collection.dto.DataManipulationDto;
import com.starhub.application.collection.dto.MetaDataLinkDto;

/**
 * 数据操作服务接口
 * @version: V1.0
 * @author: liuhf
 * @time 2025-06-06
 */
public interface DataManipulationService {

    /**
     * 保存数据
     * @param dataManipulationDto 数据操作DTO
     * @return 数据ID
     */
    String saveData(DataManipulationDto dataManipulationDto);

    /**
     * 更新数据
     * @param dataManipulationDto 数据操作DTO
     * @return 是否更新成功
     */
    boolean updateData(DataManipulationDto dataManipulationDto);

    /**
     * 删除数据
     * @param dataManipulationDto 数据操作DTO
     * @return 是否删除成功
     */
    boolean deleteData(DataManipulationDto dataManipulationDto);


    /**
     * 指定关联中添加元数据关联数据
     * @param metaDataLinkDto 数据操作DTO
     * @return 是否更新成功
     */
    boolean addTargetLinkData(MetaDataLinkDto metaDataLinkDto);

    /**
     * 指定关联中更新元数据关联数据
     * @param metaDataLinkDto 数据操作DTO
     * @return 是否更新成功
     */
    boolean updateTargetLinkData(MetaDataLinkDto metaDataLinkDto);

    /**
     * 指定关联中删除指定元数据关联数据
     * @param metaDataLinkDto 数据操作DTO
     * @return 是否更新成功
     */
    boolean removeTargetLinkData(MetaDataLinkDto metaDataLinkDto);

    /**
     * 指定关联中删除所有元数据关联数据
     * @param metaDataLinkDto 数据操作DTO
     * @return 是否更新成功
     */
    boolean removeAllTargetLinkData(MetaDataLinkDto metaDataLinkDto);

    /**
     * 根据元数据ID获取主数据ID
     * @param mainCollectionId
     * @param metaCollectionId
     * @param itemIds
     * @return
     */
    List<String> getMainDatas(String mainCollectionId, String metaCollectionId, List<String> itemIds);
}
